home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / modelers / 3dv25 / 3dv.doc < prev    next >
Text File  |  1991-08-27  |  5KB  |  128 lines
  1.                    3-D VIEWER  -  Version 2.5
  2.                    ==========================
  3.  
  4.                           August 1991
  5.  
  6.  
  7. 3DV displays 3-dimensional wire-frame objects or data, with real-time
  8. rotations.  It works on IBM PC/AT compatibles, with VGA, EGA, CGA or
  9. Hercules graphics.  A Microsoft-compatible mouse is required. 
  10.  
  11. This program is made available for unrestricted use.  However, it may
  12. not be sold or included with other software.  The package may be
  13. copied and distributed freely so long as all its files are kept
  14. together, unmodified, and no remuneration of any kind is received in
  15. exchange.
  16.  
  17.  
  18.                             USAGE
  19.  
  20. Load the mouse driver before running the program.  Data file names
  21. can be given on the command line (3DV filename.ext), or later with
  22. the FILE option.  Options/commands are selected by clicking a mouse
  23. button on the appropriate selection boxes.  Perspective or orthogonal
  24. projections can be specified.
  25.  
  26. 3DV attempts to detect the graphics hardware and sets the default
  27. mode accordingly (CGA is selected if identification fails).
  28. WARNING!  With some configurations (e.g. EGA without the enhanced
  29. color monitor) hardware damage can occur if the wrong mode is
  30. selected.  The EGA mode requires a 256k EGA card and enhanced color
  31. monitor.
  32.  
  33. The FILE option presents a menu with all the files matching *.3* in
  34. the current directory.  Some samples are included.  See below how to
  35. set up your own data files.
  36.  
  37. In display mode, the position of the view point on a sphere
  38. surrounding the object is controlled by moving the mouse:
  39. horizontally changes the longitude, vertically changes latitude.
  40. Pressing a button takes you back to the options menu.  That's all
  41. there is to it!
  42.  
  43.  
  44.                  DATA FORMAT
  45.  
  46. Data is given in ASCII text files, in free format, in the following
  47. order:
  48.  
  49.     number of points
  50.     x, y, and z coordinates for each point (scaling is automatic)
  51.          ...
  52.     number of connecting lines or moves (number of items below)
  53.     point number to draw or to move to,  and color (color=0 for move)
  54.          ...
  55.  
  56. Yes, a bit obscure, but see the sample files for examples.
  57.  
  58. Capacity is limited by 10*(number of points) + 4*(moves and draws) 
  59. <= 58280 .
  60.  
  61.  
  62.             CHANGES FROM PREVIOUS VERSION (2.0)
  63.  
  64. -  Fixed memory allocation bug, increased capacity.
  65.  
  66. -  New stand-alone Hercules routines.  These ones actually work!
  67.  
  68. -  Point-and-shoot file selection.
  69.  
  70. -  Hardware auto-detect.
  71.  
  72. -  Better latitude/longitude display; previously conflicted with
  73.    ANSI.SYS.
  74.  
  75.  
  76.                     TECHNICAL INFO, ETC.
  77.  
  78. After the public release of 2.0, several people asked about the
  79. source code.  Sorry, but after thinking about it I decided not to
  80. make it available.  Among other things, it is not a pretty sight. 
  81. Believe it or not, 3dv originated from a Basic and Z80 Assembler
  82. version that run on my TRS-80 clone (made in HongKong, yes, they
  83. invented the clones!  BTW, it still works), with a homemade graphics
  84. card based on the TI TMS9929A chip (256x192 pixels).  The port to the
  85. PC was one of my first uses of C and 8086 Assembler, several years
  86. ago.  Definitely not fit for human consumption.
  87.  
  88. If you must know, 3dv is written in Turbo C, with fast line drawing
  89. routines in assembler.  Speed is due largely to the use of 16 bit
  90. integer arithmetic, with careful scaling and arrangement of
  91. computations to maintain precision while avoiding overflow (as in the
  92. good old days).  Note, however, that absolute precision is a bit
  93. lower than the display resolution.  Uses double buffering, swapping
  94. between two video pages (except CGA that buffers from RAM).  VGA uses
  95. only the EGA 640x350 mode, which is the highest standard mode with
  96. two video pages.  The performance of buffering in RAM for higher
  97. resolution modes might or might not be acceptable, and hi-res paging
  98. may be possible with SVGA, but I have wasted enough of my time
  99. already.  No further versions are planned unless, perhaps, if some
  100. horrible bug is discovered (or I receive some offer that I can't
  101. refuse).
  102.  
  103.  
  104.                     CREDITS FOR EXAMPLES
  105.  
  106. SKULL.3D and 2SKULLS.3D -  Prehistoric Pacific islands skulls.
  107.    Dr Foss Leach (srgibfl@wnv.dsir.govt.nz), National Museum of New
  108.    Zealand.
  109.  
  110. TREE1.3D -  Pine branch measurements, from crown architecture study.
  111.    Dr David Whitehead (whitehed@mof.govt.nz), Forest Research
  112.    Institute.
  113.  
  114. GLASS.3D -  Stolen from example by Gershon Elber in GNUPLOT (a
  115.    very good plotting package, recommended.  Look for 
  116.    <MSDOS.PLOT>GPLOT-3D.ZIP in SIMTEL20).
  117.  
  118. GALAXY.3D - From "A simulated view of the Galaxy" by Mark Dahmke,
  119.    BYTE, April 1979, p 66-80.
  120.  
  121.  
  122. Send me your favorite 3dv pretty pictures.  We could distribute
  123. collections of them if there is enough interest and contributions.
  124.  
  125.  
  126. Oscar García (garciao@mof.govt.nz) - 1 Clyde St, Rotorua, New Zealand.
  127.  
  128.